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About This Book 


Audience and Purpose 


This book is intended for all persons who will be using the IBM 
AIX /RT™ publications library. It contains a library overview and 
an index to the books you might need to install, operate, or 
program the IBM AIX/RT. 

This book will lead you to the answers for such commonly asked 
questions as: How can I customize my system? What books help 
me set up the system? Where can I find the procedure to copy a 
file? What is a relative path name ? 

This book is not intended to tell you everything about a subject, 
but it is intended to tell you where to look for answers to questions 
about the RT. 


Advanced Interactive Executive and AIX are trademarks of International 
Business Machines Corporation. 

RT is a registered trademark of International Business Machines Corporation. 
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How This Book is Arranged 


This book is divided into two chapters: 

• Chapter 1, "Bibliography," describes the books that make up the 
IBM RT hardware library and the IBM RT AIX Operating 
System library. It shows you how the books relate to the tasks 
you will want to perform with the RT. 

• Chapter 2, "Master Index," is an index to the books in the RT 
library. If you need information about a particular item but do 
not know where to find the information, turn to the Master 
Index. Each index entry is followed by an abbreviation, such as 
Cmd. This abbreviation refers to the Commands Reference, and 
directs you to that book for the information. You can then use 
the index or table of contents for the specific book to get to a 
specific page number or chapter. 

A list of indexed books and their abbreviations is at the 
beginning of Chapter 2. Also, in Chapter 1, "Bibliography", the 
book abbreviation follows the book name in each individual 
description. 


Ordering Additional Copies of This Book 

To order additional copies of this book from your IBM 
representative, use Order Number SC23-2023-1. 
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About This Chapter 


This chapter contains an overview of the publications that support 
the IBM RT hardware and the IBM RT AIX Operating System. In 
this chapter, you can find information about ordering additional 
publications, as well as brief descriptions of the publications. You 
can use these descriptions to help determine which books you need 
to use to do specific tasks with the RT system. An index to each of 
these publications is contained in Chapter 2. 


Bibliography 
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Introducing the RT Hardware and AIX Operating System 
Library 


The IBM RT and AIX Operating System library is designed to help 
you easily find and use the information you need when installing 
and operating the RT system. 

Three basic types of information describe how to install and use 
the system: tutorial, guide, and reference. 


Tutorial Information 

Tutorial information presents procedures and explanations to help 
the inexperienced computer user understand and use the basic 
system concepts and functions. For example, tutorial information 
explains what a file is, why you need files, and how to create files 
using screen prompts. Basic steps take you through each action 
required. 


Guide Information 

Guide information includes more user tasks than tutorial 
information, and is directed toward someone who is familiar with 
computers or with the RT system, or someone who has worked 
through tutorial information. Unlike tutorial information, guide 
information generally contains more discussion of concepts, and 
also includes instructional steps for some tasks. Guide information 
is layered to teach you about the basic concepts, followed by the 
more complex. This layering allows you to proceed at the pace 
that is most comfortable for you. Layered information also consists 
of two paths. The first path contains only the minimum steps 
required to do a task. These steps are surrounded by a box so that 
you can more easily find them. Following the step box, a second 
path is provided to give you more detailed information. This 
second path shows you, for example, the screen that is displayed 
after doing a step, or it gives you tips or useful information about 
completing a step. 
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Reference Information 


Reference information provides complete descriptions of the 
available functions, not just selected task information. For 
example, in command reference material, all commands are listed 
alphabetically with brief, but complete, descriptions of the 
command purpose, the command parameters or operands, and 
examples where appropriate. This type of information is directed 
toward the more experienced computer user or one who has worked 
through tutorial and guide information. 


Library Description 


When you received the RT system, it included the publications you 
need for general operations and use. Other technical publications 
are available optionally and are directed toward specific uses of 
the system, such as programming. Each of these publications is 
described on the following pages. 

If you want additional copies of any of these publications, you can 
use the order number listed after the book name to order copies 
from your IBM representative. 


Bibliography 
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Introductory Publications 


The following books introduce you to the RT system hardware and 
software. These books are: 


• IBM RT system General Information, Version 2.2 (GC23-2129) 

• IBM RT Planning Guide, Version 2.2 (GC23-0782). 


Following are brief descriptions of these publications. 


General 

Information 



RT General Information ( GInfo ) gives an overview of 
RT hardware, software, and communications facilities. 
It also includes information on international character 
support. This manual is intended to provide 
information to help you decide whether to buy an RT. 


Planning Guide (Plan) provides information for site 
planning and preparation, software planning, and 
communications planning. The site planning and 
preparation information includes some physical 
specifications of the RT system units, devices, and 
cables. The software planning information includes 
prerequisites, corequisites, and recommended memory 
for certain software products. The communications 
planning information includes prerequisites, 
corequisites, and network configuration requirements 
of certain communications products. This book should 
be consulted before ordering RT products. 
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Hardware Library 


When you receive the IBM 6151 System Unit, or the IBM 6150 
System Unit, a separate box contains the following books: 

• IBM RT Guide to Operations (Order Number: SBOF-1828) 

• IBM RT User Setup Guide and IBM RT Options Installation 
(Order Number: SBOF-1829) 

• IBM RT Problem Determination Guide (Order Number: 
SBOF-1825) 

• IBM 6150 System Unit, Hardware Maintenance and Service 
(Order Number: SBOF-1826) 

OR 


IBM 6151 System Unit, Hardware Maintenance and Service 
(Order Number: SBOF-1827). 


Following are brief descriptions of the books. 




Guide to Operations ( GTO) describes the IBM 6151 and 
IBM 6150 system units, the displays, keyboard, and 
other devices that can be attached. This guide also 
includes procedures for operating the hardware and 
moving the IBM 6151 and IBM 6150 system units. 


User Setup Guide (Setup) provides instructions for 
setting up and connecting devices to system units. This 
book also gives procedures for testing the setup. 
(Packaged with Options Installation.) 
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Options Installation (Opt) provides instructions for 
installing optional adapters in IBM 6151 and IBM 6150 
and installing fixed-disk and diskette drives in IBM 
6150. (Packaged with User Setup Guide.) 


Problem Determination Guide ( PDG ) provides 
instructions for running diagnostic routines to locate 
and identify hardware problems. A problem 
determination guide for software and three 
high-capacity (1.2MB) diskettes containing the IBM RT 
diagnostic routines are included. 


6150 Maintenance and Service (6150) provides service 
procedures for the service technician to isolate and 
repair hardware failures in the 6150 system unit. This 
book also includes a set of wrap plugs. 


6151 Maintenance and Service (6151) provides service 
procedures for the service technician to isolate and 
repair hardware failures in the 6151 system unit. This 
book also includes a set of wrap plugs. 
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You can also purchase IBM RT Hardware Technical Reference 
(Order Number: SBOF-1830), which gives you more detailed 
information about the RT devices. 

Hardware Technical Reference (HwTR) is a 
three-volume set. Volume I describes how the system 
unit operates, including I/O interfaces, serial ports, 
memory interfaces, and CPU interface instructions. 
Volumes II and III describe adapter interfaces for 
optional devices and communications and includes 
information about IBM Personal Computer family 
options and the adapters supported by IBM 6151 and 
6150. 




Hardware 

Technical 

Reference 


Bibliography 
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Operating System Library 

When you receive the AIX Operating System, a box includes the 
following books: 

• IBM RT Installing and Customizing the AIX Operating System, 
Version 2.2 (Order Number: SBOF-1817) 

• IBM RT Messages Reference, Version 2.2 (Order Number: 
SBOF-1822) 

• IBM RT Using the AIX Operating System, Version 2.2 (Order 
Number: SBOF-1809) 

• IBM RT Managing the AIX Operating System, Version 2.2 
(Order Number: SBOF-1810) 

• IBM RT Usability Services Guide, Version 2.1 and IBM RT 
Usability Services Reference, Version 2.1 (Order Number: 
SBOF-0149) 

• IBM RT INed 1 , Version 2.1 (Order Number: SBOF-0160) 

• IBM RT Commands Reference, Version 2.2 (Order Number: 
SBOF-1814). 

In addition to these books, IBM RT Exploring Usability Services, 
Version 1.0, an online tutorial, is shipped with the AIX Operating 
System diskettes. 


i INed is a registered trademark of INTERACTIVE Systems Corporation. 
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Following are brief descriptions of these publications. 


Installing and 
Customizing 
the AIX 
Operating 
System 


Messages 

Reference 



Managing 
the AIX 
Operating 
System 



Installing and Customizing the Operating System 
( Install ) provides step-by-step instructions for installing 
and customizing the AIX Operating System, including 
how to add or delete devices from the system and how 
to define device characteristics. This book also 
explains how to create, delete, or change AIX and 
non-AIX minidisks. 

Messages Reference (Msgs) lists messages displayed by 
the RT and explains how to respond to the messages. 


Using the AIX Operating System (Use) describes using 
the AIX Operating System commands, working with file 
systems, developing shell procedures, and using data 
communications facilities. 


Managing the AIX Operating System (Man) provides 
instructions for performing such system management 
tasks as adding and deleting user IDs, creating and 
mounting file systems, and repairing file system 
damage, and managing data communications facilities. 


Usability Services Guide ( USGd ) shows how to create 
and print text files, work with directories, start 
applications programs, and do other basic tasks with 
Usability Services. (Packaged with Usability Services 
Reference.) 
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Usability 

Services 

Reference 


Usability Services Reference ( USRef) supplements 
Usability Services Guide by including information on 
using all of the Usability Services commands. 
(Packaged with Usability Services Guide) 



Commands 

Reference 


INed ( INed) provides guide and reference information 
for using the INed program to create and revise files. 


Commands Reference ( Cmd) lists and describes the AIX 
Operating System commands. 




Exploring Usability Services is an online tutorial for 
first-time users of Usability Services. This tutorial 
simulates the user interface and shows how to use the 
keyboard and the optional mouse, how to manipulate 
windows, how to use files and directories. 
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You can purchase the following books to learn to use 
DOS Services and to do advanced programming: 

• IBM RT Using DOS Services, Version 2.1 and IBM RT 

DOS Services Reference, Version 2.1 (Order Number: SBOF-0158) 

• IBM RT C Language Guide and Reference, Version 2.1 (Order 
Number: SBOF-0134) 

• IBM RT Programming Tools and Interfaces, Version 2.2 (Order 
Number: SBOF-1819) 

• IBM RT Operating System Technical Reference, Version 2.2 
(Order Number: SBOF-1517) 

• IBM RT Assembler Language Reference, Version 2.1 (Order 
Number: SBOF-0133) 

• IBM RT VRMj Hardware Quick Reference, Version 2.2 (Order 
Number: SC23-2022) 

• IBM RT Interface Program for use with TCP/IP, Version 2.2 
(Order Number: SBOF-1807) 

• IBM RT Keyboard Description and Character Reference, Version 
2.1 (Order Number: SBOF-0126) 

• IBM RT Base PC Network Services, Version 2.1 (Order Number 
SBOF-0131) 

• IBM RT AIX Operating System Text Formatting Guide, Version 
2.1 (Order Number: SBOF-0157) 

• IBM RT SNA Services Guide and Reference, Version 2.2 (Order 
Number: SBOF-1811) 

• IBM RT Device Driver Development Guide, Version 2.2 (Order 
Number: SBOF-1808) 
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Following are brief descriptions of these publications. 



Using DOS Services ( UsingDOS) provides step-by-step 
information for using AIX Operating System DOS 
Services. (Available optionally; packaged with 
DOS Services Reference.) 


DOS Services Reference ( DOSRef) provides reference 
information about AIX Operating System DOS Services. 
This book also includes information on sharing DOS 
files with Personal Computer AT® Coprocessor 
Services, and on the differences between PCDOS and 
DOS Services. (Available optionally; packaged with 
Using DOS Services .) 

C Language Guide and Reference ( CLang ) provides 
guide information for writing, compiling, and running 
C language programs and includes reference 
information about C language data structures, 
operators, expressions, and statements. (Available 
optionally) 

Programming Tools and Interfaces (Tools) describes the 
programming environment of the AIX Operating System 
and includes information about using operating system 
tools to develop, compile, and debug programs. In 
addition, this book describes the operating system 
services and how to take advantage of them in a 
program. This book also includes a diskette that 
contains programming examples, written in C language, 
to illustrate how to use system calls and subroutines in 
short, working programs. (Available optionally.) 


Personal Computer AT and AT are registered trademarks of International 
Business Machines Corporation. 
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Operating 

System 

Technical 

Reference 



IBM RT Operating System Technical Reference is a 
four-volume set. 

System Calls and Subroutines ( OSTR ) describes the 
system calls and subroutines that a C programmer uses 
to write programs for the AIX Operating System. 

Files and Extensions (OSTR) contains information 
about the extensions to the kernel and base operating 
system, including file formats, special files, and GSL 
subroutines. 

VRM Programming Support ( VRM) describes the VRM 
programming environment, including the internal VRM 
routines, VRM floating-point support, use of the VRM 
debugger, and the supervisor call instructions that form 
the Virtual Machine Interface. 

VRM Device Support ( VRM) describes device IPL and 
configuration, minidisk management, the virtual 
terminal and block I/O subsystems, as well as the 
interfaces to VRM device driver and data link control 
components. This volume also describes the 
programming conventions for developing your own 
VRM code and installing it on the system. (Available 
optionally) 

Assembler Language Reference (Asmb) describes the 
IBM RT Assembler Language and the 032 
Microprocessor and includes descriptions of syntax and 
semantics, machine instructions, and 
pseudo-operations. This book also shows how to link 
and run Assembler Language programs, including 
linking to programs written in C language. (Available 
optionally.) 
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VRMIHardware Quick Reference contains brief 
descriptions of the hardware and Virtual Resource 
Manager. This booklet includes information on 
command parameters and return codes and hardware 
and memory layout data. 


Interface Program for use with TCP/IP (TCPIIP) 
describes the Interface Program commands for- 
transferring data among host computers, logging into 
remote computers, and managing networks. This book 
also describes the programming interfaces to the 
Interface Program. (Available optionally.) 

Keyboard Description and Character Reference (Kybd) 
describes the national character and keyboard support 
for the 101-key, 102-key, and 106-key keyboards, 
including keyboard position codes, keyboard states, 
control code points, code sequence processing, and 
nonspacing character sequences. (Available 
optionally.) 

Base PC Network Services (Netw) describes the 
commands and interfaces that programs use to 
exchange data and messages on the PC Network. This 
book also includes information about where to find the 
IBM-provided sample programs that can be used to send 
and receive data on the PC Network. (Available 
optionally.) 

Text Formatting Guide (Text) describes the functions 
and capabilities of NROFF and TROFF to perform text 
processing tasks. (Available optionally.) 
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SNA Services 
Guide and 
Reference 



SNA Services Guide and Reference (SNA) describes the 
capabilities and functions provided by the IBM RT 
Systems Network Architecture (SNA) Services when it 
is installed on an RT. It includes information on the 
structure and operation of SNA (Systems Network 
Architecture) on the RT, configuring a network, 
controlling SNA on the local system, finding problems 
associated with SNA Services, programming using the 
SNA Services application programming interface, and 
using the Usability Services extensions that are active 
when SNA Services is installed. (Available optionally.) 

Device Driver Development Guide ( DDDGd ) provides 
information about incorporating support for additional 
input/output devices into an AIX environment on the 
IBM RT. Topics covered include kernel device drivers 
(device heads), VRM device drivers (device handlers), 
device managers, LPOSTS, display modules, 
configuration, installation, debugging, and display 
support for GSL. This book includes diskettes 
containing sample C-language programs that illustrate 
device drivers and GSL support. (Available optionally.) 


Bibliography 
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About This Chapter 


Use this Master Index with the individual publication index or 
table of contents to find the topic you want. The book 
abbreviations following the index entries correspond to the 30 
books listed in the key on the following page. For example, the 
abbreviation Tool indicates that the referenced topic is discussed 
in Programming Tools and Interfaces. 


Master Index 
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Key to the Master Index 



The books listed in the Master Index are: 


Abbreviation 

Manual Name 

Asmb 

Assembler Language Reference 

CLang 

C Language Guide and Reference 

Cmd 

Commands Reference 

DDDGd 

Device Driver Development Guide 

DOSRef 

DOS Services Reference 

GInfo 

RT General Information 

GTO 

Guide to Operations 

HwTR, any 
volume 

Hardware Technical Reference 

INed 

INed 

Install 

Installing and Customizing the Operating 

System 

Kybd 

Keyboard Description and Character 

Reference 

Man 

Managing the Operating System 

Msgs 

Messages Reference 
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| Abbreviation 

Manual Name 

Netw 

Base PC Network Services 

Opt 

Options Installation 

OSTR 

Operating System Technical Reference, 
either the System Calls and Subroutines, or 
the Files and Extensions 

Plan 

Planning Guide 

PDG 

Problem Determination Guide 

Setup 

User Setup Guide 

SNA 

SNA Services Guide and Reference 

TCP/IP 

Interface Program for Use With TCP/IP 

Text 

Text Formatting Guide 

Tools 

Programming Tools and Interfaces 

USGd 

Usability Services Guide 

Use 

Using the AIX Operating System 

UsingDOS 

Using DOS Services 

USRef 

Usability Services Reference 

VRM 

Operating System Technical Reference, 
either the VRM Programming Support, or the 
VRM Device Support 
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Abbreviation 

Manual Name 

6150 

6150 Maintenance and Service 

6151 

6151 Maintenance and Service 
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Special Characters 


. . . (dot files) INed 
.DEFAULT Tools 
.put dir directory INed 
.SUFFIXES Tools 
< DOSRef, Use 
$ prompt Use 
$ < macro Tools 
$$@ macro Tools 
$* macro Tools 
$% macro Tools 
$? macro Tools 
$@ macro Tools 
* global character DOSRef 
/ (root) Man 
/dev/sna SNA 
/etc/autolog Man 
/etc/ddi OSTR 
/etc/environment Man 
/etc/filesystems OSTR, Man 
/etc/group OSTR, Man 
/etc/master OSTR, Man, SNA 
/etc/passwd OSTR, Man, SNA 
/etc/profile OSTR, Man 
/etc/qconfig OSTR, Man 
/etc/rc Man, SNA 
/etc/system Man, SNA 
/lpp file restrictions VRM 
/minidisk Install 
/tmp Man 

/tmp minidisk Install 
/u Man 

/u space allocation Install 
/usr Man, SNA 


Index 


/usr minidisk Install 
/usr/include SNA 
/usr/include/luxsna.h SNA 
/usr/include/sys/select.h SNA 
/usr/include/sys/time.h SNA 
/usr/lib/libsna.a SNA 
/usr/lib/samples directory VRM 
/usr/lpp/ < pgm-name > /lpp.hist /nsta// 
/usr/lpp/multiple/lpp.al Install 
/usr/lpp/multiple/lpp.grouplist Install 
/usr/lpp/osplus/lpp.al Install 
/vrm minidisk Install 
/vrm/lpp/vrm/lpp.hist Install 

> DOSRef, Use 

> > DOSRef, Use 

? global character DOSRef 
# Tools 

@ (at sign) on window INed 
! DOSRef 



a.out OSTR 

object module format VRM 
aa Install 

abbreviated commands Install 
abend routine VRM 
abnormal termination VRM 
abort subroutine OSTR 
abs 

command Cmd 

subroutine OSTR 
absolute 

permission assignment Use 
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value function OSTR 
accent characters VRM 
acute Kybd 
breve VRM, Kybd 
caron VRM, Kybd 
cedilla VRM, Kybd 
circumflex VRM, Kybd 
double acute VRM, Kybd 
grave VRM, Kybd 
macron VRM, Kybd 
ogonek VRM. Kybd 
overcircle VRM, Kybd 
overdot VRM, Kybd 
tilde VRM, Kybd 
umlaut VRM, Kybd 
accept socket 

connection OSTR 
subroutine OSTR 
access 

coprocessor disk DOSRef 
directories DOSRef, INed, USGd 
editor DOSRef, INed 
exclusive OSTR 
files DOSRef, INed, USGd 
history of structured file INed 
list OSTR 

minidisks after reinstalling Install 
mode DDDGd 
permission DDDGd 
permissions INed, USGd, USRef, 
GInfo 

structured files INed 
system call 

the operating system INed 
time, file OSTR 
times of a file, changing Cmd 
utmp file entry OSTR 
accessibility, determine file OSTR 
accounting Cmd, Man 
file structure OS2 R 
on the AIX Operating System GInfo 
process OSTR 
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process file OSTR 
with SOLOMON III GInfo 
acct 

file OSTR 
system call OSTR 
acct/* command Cmd 
acctcms command Cmd 
acctcom command Cmd 
acctcon command Cmd 
acctdisk command Cmd 
acctdusg command Cmd 
acctmerg command Cmd 
acctprc command Cmd 
acctwtmp subcommand Cmd 
acknowledge query 

device identifiers VRM 
dials VRM 
DMA VRM 
locator VRM 
LPF keys VRM 
physical device VRM 
terminal VRM 

acknowledgement timeout SNA 
acos subroutine 
Action key GTO 

q pfiyo fp 

command USGd, USRef 
device-specific module VRM 
virtual terminal \ RM 
windows USRef 
active state of device-specific 
module VRM 
activity 

cancel USRef, SNA 
graph, system Cmd 
manager Cmd 
reporter, system Cmd 
ACTLU SNA 

actman command Cmd, Man 
acute 

accent character OSTR, VRM, Kybd 
diacritic OSTR , Kybd 








adapter 

conflicts Install 
keywords Install 
slots in the system unit GInfo 
adapters 

asynchronous DOSRef 
display types VRM 
hardware components 6150, 6151 
install Opt 

part numbers 6150, 6151 
adb command Cmd 
add 

code to the VRM VRM 
command Install 
commands USRef 
connection SNA 
coprocessor device Install 
device description USRef 
devices Install, Cmd 
file type description USRef 
fixed disk VRM 
groups Cmd 
header flags, SCCS Cmd 
minidisks Install, USRef 
profiles SNA 
protocol procedure OSTR 
server program SNA 
tools groups USRef 
users Cmd, USRef 
users, SCCS Cmd 
addch subroutine OSTR 
addf command VRM 
additional 

operating system programs, 
updating Install 
processing program DDDGd 
programs, install Install 
windows I Ned 
additions to the AIX Operating 
System GInfo 

onrj VAnn 

address field TCP/IP 


address types TCP/IP 
constants VRM 
conversion VRM 
editor DOSRef 
IP TCP/IP 
maps HwTR 
messages VRM 
notation TCP/IP 
translation HwTR 
addstr subroutine OSTR 
adduser command Cmd 
adjustments 6150, 6151 
adm account Man 
admin command Cmd 
advanced 

Color Graphics Display GInfo 
display graphics support 
library Install, GInfo, DDDGd 
Floating-Point Accelerator OSTR, 
GInfo 

Monochrome Graphics Display GInfo 
Program-to-Program 
Communication SNA 
advantages of VMI VRM 
ae keyword Install 
afork flag OSTR 
aging information Man 
airflow Plan 

AIX Japanese Language Support Tools, 
OSTR, Cmd 

AIX Operating System Plan 
/VRM interface DDDGd 
access from the editor INed 
accounting GInfo 
additional programs Install 
advanced features GInfo 
Asynchronous Terminal 
Emulation Plan 
command pop-up USGd 
commands SNA 
commands, enter INed, USGd 
commands, repeat USGd 
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common device driver function Netw 
communication device drivers, 
overview GInfo 

communications programs GInfo 

device driver Netw, DDDGd 

device driver interface Netw 

diskette UsingDOS 

error log device driver VRM 

error messages Msgs 

file system OSTR 

file system, overview DOSRef 

files UsingDOS 

files, customize Tools 

full screen editor INed 

function and origin GInfo 

graphics support GInfo 

guidelines for new programs Tools 

install Install 

international character support, 
overview GInfo 
interrupt handler Netw 
introduction GInfo 
log in Install 
log off Install 
logging in UsingDOS 
messages Msgs 
minidisk size requirements in 
blocks Install 
names DOSRef, UsingDOS 
optionally installable programs GInfo 
publications GInfo 
reinstall Install 
system calls SNA 
system name, extended OSTR 
system name, get OSTR 
text formatting commands Text 
trace collector OSTR 
trace log device driver VRM 
VRM interface DDDGd 
window, closing SNA 
AIX/RT network file system Tools, Man, 
OSTR, Msgs, Cmd 
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alias SNA 

all-points-addressable mode VRM 
allocate 

conversation SNA 
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